Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 17 - File Objects / File Objects Reference

File Objects Routines / Accessing File Objects

Q3File_Cancel

You can use the Q3File_Cancel function to cancel a file object.

TQ3Status Q3File_Cancel (TQ3FileObject file);

file

A file object.

DESCRIPTION

The Q3File_Cancel function removes from memory any data associated with the file object specified by the file parameter and disposes of the file object itself. You should call Q3File_Cancel when some fatal error occurs in your application or simply when you're finished using a file object. Once the file object has been canceled, you can no longer read data from it or write data to it. In all likelihood, the file object is corrupt after you call the Q3File_Cancel function.

ERRORS

kQ3ErrorInvalidObjectParameter
kQ3ErrorOSError